.pl 29.7c
.\" $Id: scrmgr.1,v 1.3 2004/07/11 08:04:47 bhepple Exp $
.TH "Screen Manager" 1 "Tue Nov 3 1992" "\&\(co Bob Hepple"
.if n .ds dg *
.if t .ds dg \(dg
.UC 4
.SH NAME
.LP
Screen Manager \- a collection of screen based tools for Unix and
MS-DOS PC's.
.SH "NAVIGATING SCREEN MANAGER SCREENS"
.LP
Special keys are provided to help moving around the screen.
If the
.B terminfo
\'meta' capaility is provided, the
.B "Screen Manager"
takes full advantage of it but can use the less satisfactory ESC-
equivalent explained below.
Provided the
.B terminfo
entry is properly defined, you can use the cursor and function keys in
addition to the following (^A means control-A, M-A is meta-A and ESC-A
is escape followed by A).
Help is available by pressing ESC-H or
Meta-H:
.RS
.TP
.B ^A
Move to the far left in the current field
.TP
.B ^B
One character left
.TP
.B ^C
Cancel current operation (usually in response to a prompt)
.TP
.B ^D
Delete the character under the curser (same as the
.I delete
key).
.TP
.B ^E
Move to the far right in the current field
.TP
.B ^F
One
character right
.TP
.B ^H
Delete one character backwards
.TP
.B ^I
(tab)
Move to next field
.TP
.B ^J/^M
(return/enter) Move to next
field
.TP
.B ^K
Clear to the end of the field
.TP
.B ^L
Refresh the
screen
.TP
.B ^N
Move down one line (this may move to another field or
to another record in a scrolling screen)
.TP
.B ^T
Transpose
characters
.TP
.B ^U
Toggle the case of characters from the current
position to the end of the field.
.TP
.B ^W
Clear the current field. Contents of the field are stored in the
field 'YANK' buffer.
.TP
.B ^Y
\'YANK' the contents of the field buffer into the field.
.TP
.B M-^I
(back tab) Move to the previous field
.TP
.B M-del
Delete previous word
.TP
.B M-a
Go to the
top of screen
.TP
.B M-A
Go to the first record
.TP
.B M-b, M-B
Move one word left
.TP
.B M-d, M-D
Delete one word
.TP
.B M-e
Go to the bottom of the screen (last field)
.TP
.B M-E
Go to the last record
.TP
.B M-f, M-F
Move one word right
.TP
.B M-h, M-H
Pop-up the key help window.
.TP
.B M-k, M-K
Clear to the end of the current screen
.TP
.B M-l, M-L
Edit a master file if there is one for the current field
.TP
.B M-m, M-M
Popup a window with available values in it.
Place the cursor on the
desired entry and press Return (or Left mouse button) to select it.
Note that fields with available popup data are usually marked with a
caret (^) at the right.
.TP
.B M-n, M-N
Go to the next record in the data.
.TP
.B M-p, M-P
Go to the previous record in the data.
.TP
.B M-r,M-R
Search & replace.
The usual UNIX regular
expressions are available.
The search is normally case insensitive but
this can be overridden with the appropriate funciton key.
.TP
.B M-s
Search for a pattern or string.
Again, the search is case insensitive
unless overidden with the function key.
.TP
.B M-S
Search for next pattern or string.
That's a capital 'S'.
.TP
.B M-t
Transpose the two words either side of the cursor.
.TP
.B M-T
Change type - this only applies to tagged files with variant records
(i.e. more than one record type in a file).
.TP
.B M-w
Copy the contents of the field to the field 'YANK' buffer. ^Y will
then copy the 'YANK' buffer into a field.
.TP
.B M-W
This brings up the
.B WHERE
screen which allows the user to perform moderately complex operations
on the data. e.g. 'find all the records between number 12 and 114 for
which the Company field is Acme Inc and change their phone number to
534-3453'
.TP
.B M-z, M-Z
Exit the program.
.TP
.B M-^A
Store the files
.TP
.B M-^C
Clear the data files
.TP
.B M-^L
Load a new file
.TP
.B M-^S
Store all data files without prompting for file names - typically in
the files specified in the
.I screenfile.
.RE
.SH FILES
.LP
The
.B "Screen Manager"
programs do not enforce any particular naming convention but the
following points are worth following.
.TP
.B Names
Since MS-DOS is the most restrictive in file naming, it is worth
sticking to the 8 character names plus 3 character extension as in
FILENAME.EXT
.TP
.B Portability
Moving data and screen files from UNIX to MS-DOS is well documented
elsewhere.
Probably the best method is to convert the files as they
are moved through the communications port - ZMODEM from DATASTORM is
a highly recommended shareware package for this.
In general, MS-DOS
and UNIX version of the
.B "Screen Manager"
convert files on input anyway.
In addition, they strip out all tab
characters (unless used as separators) and backspace characters delete
the previous character.
All other control characters are silently
ignored.
.TP
.B *.dat
Conventionally,
.B "Screen Manager"
files have a '.dat' extension although this is not required.
.TP
.B *.txt
Data files - again, this convention is not enforced.
.TP
.B *~
Before files are saved, the old file is moved to *~ as a form of
backup (*.~?? under MS-DOS).
Thus \fIproject.dat\fR would be backed up
to \fIproject.dat~\fR (\fIproject.~da\fR under MS-DOS)
.SH ENVIRONMENT
.LP
The
.B "Screen Manager"
programs generally honour the following environment parameters.
.TP
.B TMP
If specified, temporary files (if used) are put here.
Otherwise /tmp
is used.
.TP
.B EDITOR
Used by the \fIExp&Edit Screen\fR command as the default editor,
otherwise
.BR vi (1)
is used under UNIX and
.B smedit
is used under MS-DOS.
.TP
.B SHELL
Used by the global command SM_SHELL_C (usually bound to Meta-!) if set
otherwise /bin/sh is used.
.TP
.B XCTOOL
On X-window systems where the
.BR xctool (1)
shell is available (currently Sun only) normal behaviour of
.B "Screen Manager"
programs is to run as an independant X-window under xctool. 
The
.B XCTOOL
parameter can be set to the name used for xctool if changed or to stop
the use of xctool if desired (e.g. by setting XCTOOL="").
.TP
.B IN_CTOOL
Set by
.BR xctool (1)
to indicate to the child program that it is running under XCTOOL.
This is probably of little use to you except to make sure you don't
set it yourself!
.TP
.B DISPLAY
If this is set, then the
.B "Screen Manager"
programs assume they are running under X-windows.
It is usually set to
'0:' by the operating system while starting up the X-window system.
.SH "SEE ALSO"
Postscript version of these man pages which have screenshots -
probably in /usr/share/doc/scrmgr-X.Y.
.LP
.so listcomm
.SH AVAILABILITY
.LP
.TS
allbox, center, tab(;);
lb | lb |lb |lb
l | l | l | l.
Hardware;OS;Version;Format
_
PC;MS-DOS;3.1;3\(12", 5\(14" disc
PC;SCO Xenix;2.3;3\(12", 5\(14" disc
Sun-4;SunOS;4.1.1;\(14" tape
.TE
.SH BUGS
The popular PC terminal emulator \fBProcomm\fP does not appear to have an
ANSI mode compatible with UNIX (neither
.BR vi (1)
nor the
.BR "Screen Manager" ).
In addition, it cannot send META- keys.
.LP
The shareware PC terminal emulator DSZ from DATASTORM works fine
except for META- keys provided the UNIX system is prevented from
sending the tab character (use 'stty -tabs').
.LP
.B smcreate
is highly dependant on a good implementation of curses
(specifically
.BR terminfo (5)).
Before launching into these programs, please refer to the installation
guides or your system administrator to ensure that
.BR terminfo (5)
and
.B $TERM
are set correctly for the terminal you are using.
As a temporary fix
to get things limping along, you can use the Escape key instead of
\&'Meta-' and use Escape-1 ... -8 instead of the function keys f1 ...
f8.
Most other 'keychords' used by the system are vaguely similar to
the public domain text editor
.BR emacs (1).
However, please realise that
.B "Screen Manager"
is not at its best unless the function keys, the meta key and the
keypad keys (up, down, next page etc) are mapped correctly by
.BR terminfo .
.SH AUTHOR
Bob Hepple <bhepple@freeshell.org>
.SH COPYRIGHT
Copyright \(co 1991-2002 Bob Hepple
